JUnit 통합

 

 
이 섹션은 IntelliJ IDEA에서 JUnit 와 함께 작업하는 메소드를 기술합니다.  현재 IDEA는 JUnit 3.8.1과 함께 선적됩니다.
JUnit에 대한 더 많은 세부사항을 위해,  http://www.junit.org 를 참조하십시오.

JUnit Basics in Brief  

 

*   JUnit는 회귀 테스트 프레임워크입니다.

JUnit를 사용하는 보통의 메소드는 테스트 양식을 생성합니다.  테스트 양식을 생성하기 위해 당신은 TestCase 클래스를 확장하고

있는 서브 클래스를 생성할 필요가 있습니다.  또한 당신은 그들의 이름 (예를 들면, testSomething )에서 test 와 함께 시작되는

클래스에 메소드를 추가할 필요가 있습니다.
애플리케이션으로서 테스트를 실행하기 위해, 클래스에 있어서의 다음 주요한 메소드를 사용하십시오: 

 
    public static void main(String[] args) {
        new junit.textui.TestRunner().doRun(new TestSuite(<testClassName>.class));
    }
 

또 다른 방법은 클래스에서 public static Test suite() 메소드 (Test  인터페이스로부터 유래한 어떤 클래스/인터페이스를

당신이 사용할 수 있는 리턴 형태로서)를 생성합니다.

애플리케이션으로서 테스트를 실행하기 위해, 클래스에 있어서의 다음 주요한 메소드를 사용하십시오: 

 
    public static void main(String[] args) {
        new junit.textui.TestRunner().doRun(suite());
    }



JUnit 구성


첫 번째로, 당신은 JUnit 실행/디버그 구성을 생성하고, 조정할 필요가 있습니다.  

상세한 것은,  Run | Edit Configurations: Run/Debug Configurations: JUnit을 보십시오.


당신은 패키지, 클래스와 별도 메소드에 대한 JUnit 테스트를 시작할 몇 개의 방법이 있습니다.

 Toolbar로부터:
Edit Entries... 메뉴에서 적당한 JUnit 구성을 선택하고 실행/디버깅을 시작합니다.





또한 IDEA에서 당신은 팝업 메뉴를 사용하여 JUnit 테스팅을 시작할 수 있습니다.

 editor 에서 : 

그것을 테스트하는 클래스 내의 또는 이 메소드만을 테스트하는 메소드 내의 오른쪽 버튼을 클릭하십시오.


전체 클래스를 테스트하기 위해, 메소드 보디 밖에 캐럿을 놓으십시오.

만일 당신이 main() 보디 내부에 캐럿을 놓으면 테스트하는 것이 아닌 애플리케이션 실행/디버그 구성을

생성할 것 입니다.


나타나는 문맥 메뉴는 클래스 또는 메소드를 위한 JUnit 테스트를 수행하는 것을 제안합니다.

  Project View  ( Project Tab, Packages Tab  ) 와 Commander 로부터 : 

테스트 범위를 제한하는 클래스 또는 메소드(Show Members 가 on일 때  Project Tab또는 Packages Tab에서),

그것을 테스트 하기 위해서 패키지를 오른쪽 버튼 클릭하십시오.



나타나는 문맥 메뉴는 패키지/클래스/메소드를 위한 JUnit 테스트를 수행하는 것을 제안합니다.

JUnit 문맥 메뉴 항목의 외관과 기능은 몇 가지의 요소에 달려 있습니다.

첫 번째로, JUnit Run/Debug 구성이 선택된 패키지/클래스/메소드를 위해 있는지는 중요합니다.

두 번째로, 그것은 일시적일 수 있거나 영원할 수 있는 구성 타입에 의존합니다.

영구적인 구성은 특별한 패키지/메소드/클래스를 위해 명백히 생성된 구성입니다.

그러나 만일 어떤 그들을 위한 영구적인 구성이 없다면,  당신이 Run 또는 Debug를 선택할 때 일시적인 하나는

자동적으로 생성됩니다.

일시적인 Run/Debug 구성은 애플리케이션과 애플릿을 위해 또한 생성될 수 있습니다.


일시적인 구성은 기존 Run/Debug 구성 중에서 보여지고 비슷하게 관리됩니다.  그러나 단지 하나의 일시적인 구성이 존재할 수

있습니다.  당신이 영구적인 구성 없이 패키지/클래스/메소드를 위해 실행 또는 디버그를 선택할 때마다 새롭게 생성된 일시적인

구성은 오래된 임시적인 것을 교체할 것입니다.

Run "JUnit

configuration"  

기존 영구적인/일시적인 JUnit Run/Debug 구성을 수행하거나 그것을 실행하기

위해 임시적인 구성을 생성하십시오.

Debug "JUnit

configuration"  

 

기존 영구적인/일시적인 JUnit Run/Debug 구성을 디버그하거나 임시적인 구성을

생성하고 그 디버깅을 시작하십시오.

 

Test Result Tool Window  


JUnit 테스트 결과는 Run 또는 Debug 툴 윈도우의 Console 탭에서 제공됩니다.




툴 윈도우는 다음의 구성 요소로 구성됩니다:


Test tree view, Output 과 Statistics 탭 그리고 두 개의 툴바.

Test tree view 는 트리와 같은 계층으로서 모든 현재 실행된 테스트를 제공합니다.  트리 노드 이름은 클래스/메소드 이름을

테스트하기 위해 일치합니다.  테스트 메소드를 위해 충분히 자격이 주어지는 클래스 이름은 트리 노드 이름의 옆에 큰 괄호에

주어집니다.  테스트 클래스를 위해, 패키지명, 클래스가 위치하는 곳이 써집니다.

 

노드 옆의 아이콘은 그 상태를 반영합니다:

테스트는 성공적으로 통과했습니다.

테스트는 표명 또는 예외 때문에 실패했습니다.

테스트는 오류 때문에 실패했습니다.

테스트는 실행하지 않았습니다.

테스트는 정지됩니다.

테스트는 현재 실행하고 있습니다.

테스트는 중단되었습니다.


루트 노드는 다음 우선 순위와 함께 자식 노드의 "가장 나쁜" 결과에 부합하고 있는 상태 아이콘을 표시합니다:  

passed - not run - running - interrupted - assertion failure - exception failure. 

보통 테스트 클래스는 TestCase 클래스를 확장하고 테스트 메소드 이름은 test 단어로 시작됩니다.  그러나, 때때로 몇 개의 테스트

케이스가 사용되는 곳에 정적인 메소드 suite() 가 실행됩니다.  그것은 조금의 특정의 클래스 인스턴스도 관련되지 않는 한 세트의

테스트를 형성하고, 각 테스트가 아니라 일단의 테스트를 개별적으로 개시할 것 입니다.  

IDEA는 테스트 클래스로 분류된 테스트 메소드를 정확하게 표시하고 suite() 는 자식과 함께 노드로서 Result tree view 에서

나타납니다.  자식 노드는 suite()  내의 테스트입니다.

만일 당신이 Hide Passed 필터가 가능하고 모든 테스트가 특별 노드를 통과되면, All Tests Passed 는 테스트 실행의 최종에

나타납니다.



만일 Output  탭이 열리면, 트리 보기에서 요소를 선택하는 것은 강조된 테스트에 의해 생산된 출력을 표시합니다.  

그리고 만일 Statistics 탭이 열리면, 탭의 상응하는 라인은 강조될 것입니다.

Toolbars  

 

Left Toolbar  

 

현재의 JUnit 구성을 재실행 하십시오.

프로세스 출력을 중지하십시오.

현재의 JUnit 프로세스를 종료하십시오.

결과 툴 윈도우를 닫으십시오.

헬프 페이지를 엽니다.

 

Upper Toolbar  

 

Hide passed  메뉴는 통과한 테스트에 상응하는 노드를 숨기기 위해 디자인됩니다.  

모든 실행 테스트가 성공적으로 통과되고, 새로운 노드 항목, All Tests Passed 전체 트리를 치환하면서 나타납니다.

만일 눌리면 Track Running Test 버튼 현재 실행되는 노드로 트리 선택을 이동합니다. 그리고 동시에

그 출력을 Output tab에서 보입니다.

노드 트리를 확장시키십시오.  단지 두 번째 레벨 분기가 영향을 받습니다.

노드 트리를 축소시키십시오.  단지 두 번째 레벨 분기는 영향을 받습니다. 그러나, 루트 노드는 단지 필요한 노드를

더블 클릭하는 것에 의해 축소될 수 있습니다.

트리 보기에서 이전의 실패한 테스트로 네비게이트 하십시오.

트리 보기에서 다음의 실패한 테스트로 네비게이트 하십시오.

만일 Select First Failed Test When Finished 가 눌리면, 캐럿은 트리 보기에 최고의 실패한 테스트의 쪽으로

자동적으로 옮겨집니다 또한 그 출력은 Output tab 에서 표시됩니다.

만일 Scrolls to Stacktrace가 눌리면, Output tab 에서 테스트 실패를 야기한 것을 위하여 예외/표명 스택 추적의

시작으로 스택 추척 출력을 스크롤 합니다.

만일 Autoscroll to Source 가 눌리면, Test tree view 에서 테스트를 선택하면 에디터에서 소스파일 (필요하다면

그것을 열면서)로 네비게이트합니다. 에디터에서 테스트의 첫 번째 라인 위에서 캐럿을 배치했습니다.

만일 Open Source at Exception 가 눌리면, 열리는 소스 코드 (View source, Edit source, Autoscroll to

source)가 실패한 코드가 불려졌던 테스트 메소드 라인에 캐럿을 놓습니다 (같은 효과는 스택 추적에서 테스트 메소드

라인을 클릭하는 것에 의해 달성될 수 있습니다).

 

Test Status Panel  


Test Status 패널은  테스트 상황 Output 와 Statistics 위에 위치합니다.



그것은 현재의 테스트 구성을 위해 상태를 반영합니다:

Starting  

과정이 테스트에서 조금도 시작되지 않았던 테스트가 있었던 때를 표시했지만 시작했습니다.

Running  

테스트가 실행된 때를 표시했습니다.  동시에 두 그림이 주어집니다.  첫 번째는 얼마나 많은 테스트가 이미 수행되었는가를 보여주고 두 번째는 테스트의 전체 숫자입니다.

많은 테스트가 벌써 존재했던 첫번째 표시가 수행되면서, 초는 테스트의 합계수입니다.

만일 어떤 실패한 테스트가 있으면, 실패한 테스트의 총계를 또한 표시하는 Failed 레이블과 함께 표시됩니다. 현재 실행하고 있는 테스트의 이름이 또한 표시됩니다.

Terminated  

만일 테스트 실행이 사용자에 의해 중단되면 표시됩니다. 그림은 Running에 관해서는 같은 것을 의미합니다.

Done  

모든 테스트가 실행되었던 때를 표시했습니다. 그림은 Running 레이블 관해서는 같은 것을 의미합니다. 또한 토털 시간을 모든 테스트에 합격하기 위해 표시하는 또 다른 레이블이 나타납니다.

 

Progress Bar  


Progress Bar 는 얼마나 많은 테스트가 되었던가를 표시합니다.  그것은 다음 색을 가질 수 있습니다:

Green  

만일 모든 수행된 테스트가 좋게 통과되었다면 (테스트의 어는 것도 실패하지 않았다면)

Yellow  

만일 테스트 실행이 사용자에 위해 중단되고 이미 수행된 테스트의 어느 것도 실해하지 않았으면.

Red  

만일 실패한 테스트가 있으면.

 

Output Tab  


Output tab 은 테스트 실행 동안 생성된 정보를 표시합니다.  루트 노드가 Test tree view에서 선택될 때, 탭은 오류 메시지

뿐만 아니라 명령 라인, 모든 테스트의 출력을 표시합니다. 그리고 만일 어떤 다른 노드가 선택되면, 오직 선택된 노드에 대한

출력과 오류 메시지와 그 자식은 보여집니다. 각 오류는 링크를 동반합니다.  

그것을 클릭하면 당신은 에디터에서 캐럿을 설정하는 상응하는 라인에 네비게이트합니다.



문자열 비교 후의 표명이 발생할 때, 출력은 약간 다릅니다.  싱글 라인의 문자열이 비교될 때, 문자는 출력 메시지에서 정렬됩니다.



멀티라인 문자열(즉 "\n을 포함하는 그것들)이 있을 때, 출력은 링크를 포함합니다.  링크를 클릭하면 문자열 사이에서 차이를 보기

위하여  Difference View를 부릅니다.

Statistics tab  


Statistics 탭은 현재의 실행/디버그 구성을 위해 여러 가지 통계 데이터를 표시합니다.

Test  

실행되었던 모든 테스트를 위해 합계를 표시하는 첫 번째 라인을 제외하고 이 섹션은 테스트명을 표시합니다.

Time elapsed  

테스트를 실행하기 위해 경과한 시간.  Total 값은 모든 테스트의 합계 시간입니다.

Usage Before  

테스트를 실행하기 전의 RAM 사용.

Usage Delta  

테스트를 실행하기 전후의 RAM 사용의 차이.  값이 (RAM-after-test - RAM-before-test)로 계산됩니다.

 

예를 들면, 만일 gc 가 테스트 실행 동안 착수되면, 델타 값은 네거티브일 수 있습니다.

Usage After  

테스트를 실행하고 난 후의 RAM 사용.

Results  

이 칼럼은 테스트 실행의 결과를 표시합니다.  그것은 Passed, Error, Assertion이 될 것 입니다.

Total 라인 또는 어떤 복합 테스트에 대한 라인은 표명(F), 예외(E), 성공적인 통과(P) 로

얼마나 많은 테스트가 실패했는가를 보여줍니다.


탭에서 라인을 선택하면 트리 보기에서 상응하는 요소를 선택합니다.  그리고 당신은 탭에서 칼럼을 그들의 칼럼 순서를

커스터마이즈하기 위해 드래그 & 드롭할 수 있습니다.


Context menus   


문맥 메뉴는 Test tree view에서 노드를 또는 Statistics 탭에서 요소를  오른쪽 버튼을 클릭하는 것에 의해 불려집니다. 

Run "JUnit

Configuration"  

 above 의 설명을 보십시오. 

Debug "JUnit

configuration"  

 

 above 의 설명을 보십시오. 

Jump to Source  

만일 선택되면, 에디터에서 테스트 선언 라인에 캐럿을 배치하고 있는

선택된 테스트를 네비게이트하고, 초점을 거기에 옮깁니다.

Show Source  

만일 선택되면, 에디터에서 테스트 선언 라인에 캐럿을 배치하고 있는

선택된 테스트를 네비게이트합니다.

그러나 초점은 JUnit Result Tool Window에서 유지됩니다.

Select in Tree  

요소는 Statistics 탭에서만 나타납니다.  만일 선택되면, Test tree view에서

선택된 것에게 부합하고 있는 요소를 선택합니다.


Output 탭 문맥 메뉴는 다음의 두 항목을 포함합니다:

Clear All  

출력 창을 제거합니다.

Copy Content  

출력을 클립보드에 카피하십시오.

 

Advanced features  


다음 설명은 일부 Java 샘플을 이용합니다.  완전 코드는 아래에 제공됩니다.

1.  콜렉션을 비교하는 것: 

특별한 사용 케이스가 있습니다:  Difference View 는 콜렉션을 비교하기 위해 사용될 수 있습니다.  

당신은 그들을 멀티라인 문자열로 변환하고 assertEquals(String, String)를 부를 수 있습니다.

2.  특별한 사용 케이스:

o사용 케이스- 테스트 자료를 파일에 저장하는 것.

경우를 존중하지 않은 String Collection 을 소트하는 샘플 코드를 생성하십시오.  

테스트 데이터는 파일, 테스트(첫 번째는 소트된 콜렉션, 두 번째는 소팅 결과)에 따라 두 파일로서 제공됩니다.  

IDEA는 테스트 명을 절대 파일 경로로 간주할 수 있습니다.

 

 첫 번째로, 우리는 테스트 자료를 폴더에서 발견하기 위해 보조 메소드가 필요합니다.  

 
public class FSUtil {
 
  public static final String IN_EXTENSION = ".in";
  public static final String OUT_EXTENSION = ".out";
 
public static String[] findTests(File testData) {
    File[] inputs = testData.listFiles(new FilenameFilter() {
        public boolean accept(File dir, String name) {
          return name.endsWith(IN_EXTENSION);
        }
      });
    String[] names = new String[inputs.length];
    for (int i = 0; i < inputs.length; i++) { File inputFile = inputs[i]; String inputNameExt =
 inputFile.getName(); String inputName = inputNameExt.substring(0, inputNameExt.length() – 
IN_EXTENSION.length()); names[i] = inputName; } return names;
  }
}

 

사전 정의의 확장이 있는 파일은 testData 디렉터리에서 검색됩니다.  

이전의 코드와 함께 얻어지는 파일명을 위해, 테스트는 생성되고, TestSuite에 추가됩니다.

 
public class SortTestSuite extends TestSuite {
  public SortTestSuite() {
    super("Sort tests"); // Suite node name in tree view
    File testData = new File(".");
    String[] tests = FSUtil.findTests(testData);
    for (int i = 0; i < tests.length; i++) { String test = tests[i]; addTest(new MyTestCase(test,
 testData){});
    }
  }
 
  public static Test suite() {
    return new SortTestSuite();
  }
}



MyTestCase는 하나의 테스트 메소드를 가지는 클래스입니다:  

 
public void test() throws IOException { // Test method to run
    String[] result = new Sort().sort(readStrings(input));
    assertEquals(toLines(readStrings(output)), toLines(result));
}
 
우리는 Sort  클래스에 있어서의 sort()  메소드를 테스트하고 있습니다. 
 
public class Sort {
   public String[] sort(String[] strings) { //dummy sort method
    Arrays.sort(strings);
    return strings;
  }
}
 

input은 소트된 문자열을 포함하고 있는 필드입니다, output 은 예상되는 소팅 결과입니다.

readStrings() 는 파일로부터의 문자열을 읽고, 문자열 배열을 생산합니다.
toLines()는 문자열 배열을 멀티라인 문자열로 바꿉니다. 

 
public abstract class MyTestCase extends TestCase {
  private final String name;
  private final File input;
  private final File output;
 
  public MyTestCase(String name, File parentDirectory) {
    super("test"); // Passing test method name
    this.input = new File(parentDirectory, name + FSUtil.IN_EXTENSION);
    this.output = new File(parentDirectory, name + FSUtil.OUT_EXTENSION);
    try {
      this.name = this.input.getCanonicalPath();
    } catch (IOException e) {
      throw new RuntimeException(e);
    }
  }
 
  public void test() throws IOException { // Test method to run
    String[] result = new Sort().sort(readStrings(input));
    assertEquals(toLines(readStrings(output)), toLines(result));
  }
 
  private String toLines(String[] strings) {
    StringBuffer buffer = new StringBuffer();
    for (int i = 0; i < strings.length; i++) { String string = strings[i]; buffer.append(string);
 buffer.append(System.getProperty("line.separator")); } return buffer.toString();
  }
 
  private String[] readStrings(File file) throws IOException {
    BufferedReader reader = new BufferedReader(new FileReader(file));
    String line;
        ArrayList lines = new ArrayList();
    while ((line = reader.readLine()) != null) {
      lines.add(line);
    }
    return (String[])lines.toArray(new String[lines.size()]);
  }
 
  public String getName() { // Test representation in tree view
    try {
        return input.getCanonicalPath();
    } catch (IOException e) {
        return super.getName();
    }
 }
}  

  

  
 

Result tree view 의 노드명은 변경될 수 있고, getName() 콜의 출력으로서 표시됩니다.

 

getName()  메소드는 최초의 입력 데이터와 함께 파일에 즉 소트된 콜렉션으로 절대 경로를 리턴하기 위해

오버라이드 됩니다.

o                        사용 케이스 – 고속 테스트 생성
만일 테스트 수행/디버깅의 시작에서 선언된 것보다 더 많은 테스트가 있다면 IDEA는 정확하게 프로세스 합니다.

 

public class SortTest implements Test {
public int countTestCases() {
return 0;
}
 
public void run(TestResult testResult) {
File testData = new File(".");
String[] names = FSUtil.findTests(testData);
for (int i = 0; i < names.length; i++) { String name = names[i]; new MyTestCase(name, testData){}.run(testResult);
}
}
 
public static Test suite() {
return new SortTest();
}
}
   

countTestCases()는 제로를 리턴합니다 왜냐하면 우리는 얼마나 많은 데스트 파일이 발견되는지, 얼마나 많은 테스트가 실행되는지에 대해 관심을 두지 않기 때문 입니다.

run() 은 실제로 테스트를 스캐닝, 생성하고 시작 합니다.


첫 번째로, 그것이 선언되었던 것보다 테스트를 실행하는 실제 량은 높습니다.  따라서, IDEA는 얼마나 많은 테스트가 착수되었던지 가르칩니다. 그러나 많은 테스트가 존재했던 메소드는 처음에 선언하지 않았습니다. 두 번째로, 테스트는 그들의 클래스에 따라 모으게 됩니다.